home *** CD-ROM | disk | FTP | other *** search
/ Aminet 22 / Aminet 22 (1997)(GTI - Schatztruhe)[!][Dec 1997].iso / Aminet / util / wb / lupe.lha / lupe.doc < prev    next >
Text File  |  1997-10-22  |  7KB  |  178 lines
  1.  
  2.             Lupe
  3.  
  4.             Version :   1.9
  5.             Date    :   21-Oct-97
  6.             Author  :   Frank Toepper
  7.  
  8.  
  9. COPYRIGHT
  10.  
  11. This program is Public Domain, everybody can use it without charge and you
  12. can copy it freely.
  13.  
  14.  
  15. INTRODUCTION
  16.  
  17. This program magnifies an area of the screen and displays it in a seperate
  18. window.
  19.  
  20.  
  21. USAGE
  22.  
  23. This program can be started from Workbench or CLI.
  24. It will try to evaluate the following tooltypes:
  25.  
  26. CX_PRIORITY        : A number between -128 and 127 which set the priority of
  27.                       the commodity. With that the system decides in which
  28.                       succession the commodities gets the messages.
  29.                       The commodity with the highest priority gets the
  30.                       message first.
  31.                       Default is 0.
  32. FAST               : The window will often redrawn.
  33.                       Default is NO.
  34. SCALEFACTOR        : Default is 5.
  35. MAXSCALEFACTOR     : The maximum scalefactor (between 5 and 30)
  36.                       Default is 15.
  37. COORDINATES        : In the bottom border the mouse coordinates will be
  38.                       displayed.
  39.                       Default is NO.
  40. CROSSHAIR          : A crosshair visualised the position of the mouse.
  41.                       Default is NO.
  42. FIXED              : When this flag is YES/ON the center of the magnified
  43.                       area was not described by the mouse coordinates but
  44.                       it's fixed until you clicked into the window.
  45.                       Now with the holded left mousebutton you can move the
  46.                       area.
  47.                       Default is NO.
  48. SETORIGINKEY       : A hotkey to set an imaginary origin.
  49.                       Default is 'lalt o'.
  50. RESETORIGINKEY     : A hotkey to reset the imaginary origin to 0,0.
  51.                       Default is 'lalt r'.
  52. SHOWHIDEKEY        : A hotkey to open/close the window.
  53. WINLEFT
  54. WINTOP
  55. WINWIDTH
  56. WINHEIGHT          : These values describes the position and dimension of the
  57.                       window.
  58. ICONIFY            : The window will not opened.
  59.                       Default is NO.
  60. ICONIFYONCLOSE     : If you press the closebutton the program will not be
  61.                       ending.
  62.                       Default is NO.
  63. GRID               : This turns on the grid.
  64.                       Default is OFF.
  65. SHOWRGB            : In the bottom border the color values will be displayed.
  66.                       Default is OFF.
  67. IFFFILE            : Pfad und Name des Iff-Files.
  68.                       Default is 'ram:Lupe.iff'
  69. JUMPTOACTIVESCREEN : The window will always be jumping to the active
  70.                       screen.
  71.                       Default is OFF.
  72.  
  73. By starting from CLI you can specify these arguments and override the
  74. tooltypes.
  75.  
  76. "CX_PRIORITY=P/N/K, FAST=F/S/K, MAXSCALEFACTOR=M/N/K, SCALEFACTOR=S/N/K,
  77.  WINLEFT=L/N/K, WINTOP=T/N/K, WINWIDTH=W/N/K, WINHEIGHT=H/N/K,
  78.  COORDINATES=C/S/K, CROSSHAIR=R/S/K, SETORIGINKEY=O/K, RESETORIGINKEY=K/K,
  79.  FIXED=D/S/K, SHOWHIDEKEY=SH/K, ICONIFY=I/S/K, ICONIFYONCLOSE=IOC/S/K,
  80.  GRID=G/S/K, SHOWRGB=RGB/S/K, IFFFILE=IF/K, JUMPTOACTIVESCREEN=JAS/S/K,
  81.  LANGUAGE=U"
  82.  
  83. The values are the same as the tooltypes.
  84.  
  85. The scalefactor can be set with the proportional gadget nested in the right
  86. windowborder.
  87. To move the surrounding area in the 'fixed'-mode click in the window and
  88. hold down the mousebutton. Now you can move the surrounding area until you
  89. release the mousebutton.
  90.  
  91.  
  92. The menu:
  93.  
  94. Jump                  : Jumps to the next screen.
  95. Jump To Screen        : A submenu with the actually opened screens. The
  96.                          window was opened on the selected screen.
  97. Jump To Active Screen : Jumps always to the active screen.
  98. Save IFF...           : Saves the actual contents of the window as iff file.
  99. Enable                : Here you can enable or disable the lens.
  100. Fixed                 : Switches the Fixed-mode on/off.
  101.                          If it's on the center of the magnified area was not
  102.                          described by the mouse coordinates but it's fixed
  103.                          until you clicked into the window.
  104.                          Now with the holded left mousebutton you can move
  105.                          the area.
  106. Fast                  : Switches to the Fast mode.
  107. Coordinates           : Shows the mouse coordinates in the bottom
  108.                          windowborder.
  109. Crosshair             : Switches the crosshair ON/OFF.
  110. Grid                  : This turns on/off the grid.
  111. Show RGB              : In the bottom border the color values will be
  112.                          displayed.
  113. About                 : Shows program information.
  114. Iconify On Close      : If you press the closebutton the program will be
  115.                          iconified.
  116. Iconify               : Closes the window. You can open it again by pressing
  117.                          the hotkey or with the program 'Exchange'.
  118. Quit                  : Leaves the program.
  119.  
  120. The keys:
  121.  
  122. '+'      : Scalefactor + 1
  123. '-'      : Scalefactor - 1
  124. 'J'      : Jump to next screen.
  125. 'A'      : Jump to active screen.
  126. 'S'      : IFF save.
  127. 'E'      : activates/deactivates the lens.
  128. 'F'      : Fast mode on/off.
  129. 'C'      : Coordinates on/off.
  130. 'R'      : Crosshair on/off.
  131. 'O'      : set the imaginary origin to the actuall mouse coordinates.
  132. 'K'      : reset the imaginary origin to 0,0.
  133. 'D'      : Switches the Fixed-mode on/off.
  134. '?'      : Shows program information.
  135. 'N'      : If you press the closebutton the program will be iconified.
  136. 'I'      : Closes the window.
  137. 'G'      : Turns on/off the grid.
  138. 'W'      : Turns on/off the show RGB.
  139. 'Q',ESC  : Leaves the program.
  140. Additionally in Fixed-mode the area can be moved by the cursorkeys.
  141. Whereby the area will be moved by one 'page' with pressed shift-key, to
  142. the extremity with pressed alt-key or else 1 pixel.
  143.  
  144. The hotkeys:
  145.  
  146. 'lalt l' : Iconify/uniconify.
  147. 'lalt o' : Set origin.
  148. 'lalt r' : Reset origin.
  149.  
  150.  
  151. DISCLAIMER
  152.  
  153. Allright, here it is : you use Lupe at your own risk. I cannot be
  154. responsible for any damage happening caused by using it.
  155.  
  156.  
  157. AUTHOR
  158.  
  159. Bugrepots or what ever you want to:
  160.  
  161.    Frank Toepper
  162.    Maxim Gorki Straße 5A
  163.    Greifswald
  164.    17491
  165.    Germany
  166.  
  167. or via e-Mail (prefered): toepper@rz.uni-greifswald.de
  168.  
  169. WWW: http://www.user.fh-stralsund.de/~rwermke/di.html
  170.  
  171.  
  172. CREDITS
  173.  
  174. Thanks goes to Thomas Byrer, Allan Odgaard, Tilo KÜhn, Troels Walsted
  175. Hansen, Olaf Groener, Philippe Casidy, John Wehler and Stephane Dudez for
  176. their ideas, to the betatesters Meni Berman, Georges Goncalves, Ralph
  177. Wermke, Ronny Dudeck and Michael Knoke.
  178.